home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.6 / catclock.6 < prev    next >
Text File  |  1995-07-25  |  15KB  |  331 lines
  1.  
  2.  
  3.  
  4.      CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 4444))))          CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           catclock - analog / digital / cat clock for X
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ccccaaaattttcccclllloooocccckkkk [-_t_o_o_l_k_i_t_o_p_t_i_o_n ...]
  13.                    [-mode _a_n_a_l_o_g | _d_i_g_i_t_a_l | _c_a_t]
  14.                    [-alarm] [-bell] [-chime] [-file _f_i_l_e_n_a_m_e]
  15.                    [-hd _c_o_l_o_r] [-hl _c_o_l_o_r]
  16.                    [-catcolor _c_o_l_o_r] [-detailcolor _c_o_l_o_r] [-tiecolor
  17.           _c_o_l_o_r]
  18.                    [-update _s_e_c_o_n_d_s] [-padding _n_u_m_b_e_r]
  19.                    [-period _s_e_c_o_n_d_s] [-ntails _n_u_m_b_e_r] [-help]
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           The _c_a_t_c_l_o_c_k program displays the time in analog, digital,
  23.           or cat form.  The time is continuously updated at a
  24.           frequency which may be specified by the user.
  25.  
  26.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  27.           _C_a_t_c_l_o_c_k accepts all of the standard X Toolkit command line
  28.           options along with the additional options listed below:
  29.  
  30.           ----mmmmooooddddeeee _m_o_d_e
  31.                   Determines display mode. Modes are _a_n_a_l_o_g, _d_i_g_i_t_a_l,
  32.                   and _c_a_t.  Analog mode displays a conventional 12
  33.                   hour clock face with ``ticks'' for each minute and
  34.                   stroke marks on each hour. Digital mode displays an
  35.                   ascii string corresponding to the time. Cat mode
  36.                   displays an image of the famous "Kit Cat (R)"
  37.                   plastic clock, complete with pendulum tail. The
  38.                   default is _c_a_t.
  39.  
  40.           ----aaaallllaaaarrrrmmmm  Turns the alarm on.  If the alarm file exists and
  41.                   has valid alarm entries, a bell is displayed in the
  42.                   clock window.
  43.  
  44.           ----bbbbeeeellllllll   Turns the alarm bell on, sounding when an alarm is
  45.                   reached.
  46.  
  47.           ----cccchhhhiiiimmmmeeee  This option indicates that the clock should chime
  48.                   once on the half hour and twice on the hour.
  49.  
  50.           ----ffffiiiilllleeee _a_l_a_r_m_f_i_l_e
  51.                   Specifies an alternate alarm file.  The default is
  52.                   ~/._C_a_t_c_l_o_c_k.
  53.  
  54.           ----hhhhdddd _c_o_l_o_r
  55.                   This option specifies the color of the hands on an
  56.                   analog clock.  The default is _b_l_a_c_k.
  57.  
  58.           ----hhhhllll _c_o_l_o_r
  59.                   This option specifies the color of the edges of the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/22/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 4444))))          CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))
  71.  
  72.  
  73.  
  74.                   hands on an analog clock, and is only useful on
  75.                   color displays.  The default is _b_l_a_c_k.
  76.  
  77.           ----ccccaaaattttccccoooolllloooorrrr _c_o_l_o_r
  78.                   For cat mode -- determines the color of the cat's
  79.                   body.  The default color is _b_l_a_c_k.
  80.  
  81.           ----ddddeeeettttaaaaiiiillllccccoooolllloooorrrr _c_o_l_o_r
  82.                   For cat mode -- determines the color of the cat's
  83.                   face, paws, and belly.  The default color is _w_h_i_t_e.
  84.  
  85.           ----ttttiiiieeeeccccoooolllloooorrrr _c_o_l_o_r
  86.                   For cat mode -- determines the color of the cat's
  87.                   tie.  The default color is _w_h_i_t_e.
  88.  
  89.           ----uuuuppppddddaaaatttteeee _s_e_c_o_n_d_s
  90.                   This option specifies the frequency in seconds at
  91.                   which _c_a_t_c_l_o_c_k should update its display.  If the
  92.                   clock is obscured and then exposed, it will be
  93.                   updated immediately.  A value of less than 30
  94.                   seconds will enable a second hand on an analog
  95.                   clock.  The default is _6_0.
  96.  
  97.           ----ppppaaaaddddddddiiiinnnngggg _n_u_m_b_e_r
  98.                   This option specifies the width in pixels of the
  99.                   padding between the window border and clock text or
  100.                   picture.  The default is _1_0 on a digital clock and _8
  101.                   on an analog clock.
  102.  
  103.           ----ppppeeeerrrriiiioooodddd _s_e_c_o_n_d_s
  104.                   Gives the period in seconds of the alarm bell
  105.                   (default is _6_0).
  106.  
  107.           ----nnnnttttaaaaiiiillllssss _n_u_m_b_e_r
  108.                   In cat mode, determines the number of tails per
  109.                   ``sweep'', which affects the smoothness of the
  110.                   swinging pendulum tail. The default is _1_6.
  111.  
  112.           ----hhhheeeellllpppp   This option indicates that a brief summary of the
  113.                   allowed options should be printed on the standard
  114.                   error.
  115.  
  116.  
  117.      XXXX DDDDEEEEFFFFAAAAUUUULLLLTTTTSSSS
  118.           This program understands all of the usual Xt resources as
  119.           well as the following:
  120.  
  121.           mmmmooooddddeeee ((((class SSSSttttrrrriiiinnnngggg))))
  122.                   Specifies the display mode -- _a_n_a_l_o_g, _d_i_g_i_t_a_l, or
  123.                   _c_a_t.  The default is _c_a_t.
  124.  
  125.           aaaallllaaaarrrrmmmm ((((class BBBBoooooooolllleeeeaaaannnn))))
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/22/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 4444))))          CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))
  137.  
  138.  
  139.  
  140.                   Specifies whether or not the alarm should be set on
  141.                   startup.  The default is _o_f_f.
  142.  
  143.           bbbbeeeellllllll ((((class BBBBoooooooolllleeeeaaaannnn))))
  144.                   Specifies whether or not a bell should be rung when
  145.                   the alarm goes off.  The default is _o_f_f.
  146.  
  147.           cccchhhhiiiimmmmeeee ((((class BBBBoooooooolllleeeeaaaannnn))))
  148.                   Specifies whether or not a bell should be rung on
  149.                   the hour and half hour.  The default is _o_f_f.
  150.  
  151.           hhhhaaaannnnddddssss ((((class FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
  152.                   Specifies the color of the insides of the clock's
  153.                   hands. The default depends on whether _r_e_v_e_r_s_e_V_i_d_e_o
  154.                   is specified.  If _r_e_v_e_r_s_e_V_i_d_e_o is specified the
  155.                   default is _w_h_i_t_e, otherwise the default is _b_l_a_c_k.
  156.  
  157.           hhhhiiiigggghhhhlllliiiigggghhhhtttt ((((class FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
  158.                   Specifies the color used to highlight the clock's
  159.                   hands. The default depends on whether _r_e_v_e_r_s_e_V_i_d_e_o
  160.                   is specified. If _r_e_v_e_r_s_e_V_i_d_e_o is specified the
  161.                   default is _w_h_i_t_e, otherwise the default is _b_l_a_c_k.
  162.  
  163.           ccccaaaattttCCCCoooolllloooorrrr ((((class FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
  164.                   Specifies the color used for the cat's body.. The
  165.                   default depends on whether _r_e_v_e_r_s_e_V_i_d_e_o is
  166.                   specified.  If _r_e_v_e_r_s_e_V_i_d_e_o is specified the default
  167.                   is _w_h_i_t_e, otherwise the default is _b_l_a_c_k.
  168.  
  169.           ddddeeeettttaaaaiiiillllCCCCoooolllloooorrrr ((((class FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
  170.                   Specifies the color used for the cat's belly, eyes,
  171.                   and paws. The default depends on whether
  172.                   _r_e_v_e_r_s_e_V_i_d_e_o is specified.  If _r_e_v_e_r_s_e_V_i_d_e_o is
  173.                   specified the default is _b_l_a_c_k, otherwise the
  174.                   default is _w_h_i_t_e.
  175.  
  176.           ttttiiiieeeeCCCCoooolllloooorrrr ((((class FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
  177.                   Specifies the color used for the cat's bow tie. The
  178.                   default depends on whether _r_e_v_e_r_s_e_V_i_d_e_o is
  179.                   specified.  If _r_e_v_e_r_s_e_V_i_d_e_o is specified the default
  180.                   is _b_l_a_c_k, otherwise the default is _w_h_i_t_e.
  181.  
  182.           uuuuppppddddaaaatttteeee ((((class IIIInnnntttteeeerrrrvvvvaaaallll))))
  183.                   Specifies the frequency in seconds at which the time
  184.                   should be redisplayed.
  185.  
  186.           ppppaaaaddddddddiiiinnnngggg ((((class MMMMaaaarrrrggggiiiinnnn))))
  187.                   Specifies the amount of internal padding in pixels
  188.                   to be used.  The default is _8.
  189.  
  190.           ppppeeeerrrriiiioooodddd ((((class IIIInnnntttteeeerrrrvvvvaaaallll))))
  191.                   Specifies the period of the alarm bell. The default
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/22/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 4444))))          CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))
  203.  
  204.  
  205.  
  206.                   is _6_0.
  207.  
  208.           nnnnTTTTaaaaiiiillllssss ((((class CCCCaaaarrrrddddiiiinnnnaaaallll))))
  209.                   Specifies the number of tails per sweep.  The
  210.                   default is _1_6.
  211.  
  212.  
  213.      MMMMEEEENNNNUUUU
  214.           A popup menu is displayed when any mouse button is pressed
  215.           and held within the _c_a_t_c_l_o_c_k window.  Selecting and
  216.           releasing the button over the ``Alarm Set'', ``Alarm Bell''
  217.           or ``Chime'' toggles their state.
  218.  
  219.           The middle band of menu items are commands to perform (see
  220.           ALARM FUNCTION below).  The ``Exit'' menu item causes
  221.           _c_a_t_c_l_o_c_k to exit.
  222.  
  223.      AAAALLLLAAAARRRRMMMM FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN
  224.           _C_a_t_c_l_o_c_k reads the alarm file to obtain the nearest alarm.
  225.           The alarm file is consulted periodically to see if it has
  226.           been changed and there is a more recent alarm, but to
  227.           guarantee that the alarm file is read, use the menu item
  228.           ``Reread Alarm File''.
  229.  
  230.           To make changes to the alarm file, select menu item ``Edit
  231.           Alarm File''.  The editor specified by the EDITOR
  232.           environment variable will be run on the alarm file.  The
  233.           default editor is vi.  Emacs users who use GNU Emacs will
  234.           have that editor appear in its own window, while "other"
  235.           emacs versions will appear in an xterm window.
  236.  
  237.  
  238.  
  239.           After an alarm has been rung, select either the
  240.           ``Acknowledge Alarm'' or the ``Reread Alarm File'' menu
  241.           items.  This will terminate the current alarm and cause the
  242.           next alarm in sequence to be activated.
  243.  
  244.           Each line in the file is an alarm composed of up to 4
  245.           fields.  The first fields must be space separated, and the
  246.           last field (the message field) must be separated from the
  247.           previous fields with tabs.  The first field is optional and
  248.           gives the day of the week for the alarm to happen (no day of
  249.           week means a daily alarm).
  250.  
  251.           The next field is the time field and must contain a colon
  252.           separating the hour from the minute.  The third (optional)
  253.           field may contain AM or PM (any case) specifying normal
  254.           time.  If no AM/PM indication is given, 24-hour time is
  255.           assumed.
  256.  
  257.           The final field is a message that is displayed when the
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 6/22/95)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))         XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 4444))))          CCCCAAAATTTTCCCCLLLLOOOOCCCCKKKK((((1111))))
  269.  
  270.  
  271.  
  272.           alarm goes off.  The text is scrolled from right to left
  273.           within the _c_a_t_c_l_o_c_k window.
  274.  
  275.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  276.             Mon. 1:30 pm      Staff meeting
  277.             Thur. 15:30       Management meeting
  278.             11:55 am          Time for lunch
  279.  
  280.  
  281.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  282.           DDDDIIIISSSSPPPPLLLLAAAAYYYY     to get the default host and display number.
  283.  
  284.           EEEEDDDDIIIITTTTOOOORRRR      to specify the editor to use in modifying the
  285.                       alarm file.
  286.  
  287.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  288.           X(1), xrdb(1), time(3C)
  289.  
  290.      BBBBUUUUGGGGSSSS
  291.           _C_a_t_c_l_o_c_k believes the system clock.
  292.  
  293.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  294.           Copyright 1988, Massachusetts Institute of Technology.
  295.           See _X(_1) for a full statement of rights and permissions.
  296.  
  297.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  298.           Tony Della Fera (MIT-Athena, DEC)
  299.           Dave Mankins (MIT-Athena, BBN)
  300.           Ed Moy (UC Berkeley)
  301.           Deanna Hohn (DEC) created the cat pixmaps.
  302.           Philip Schneider (DEC) created the pendulum tails and eyes,
  303.           and ported the program to Motif 1.1.
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 6/22/95)
  328.  
  329.  
  330.  
  331.